home *** CD-ROM | disk | FTP | other *** search
/ Object Oriented Applicat…isualAge for C++ for OS/2 / Object-Oriented Application Development with VisualAGE for C++ for OS2.iso / read.me < prev    next >
Text File  |  1996-03-07  |  10KB  |  233 lines
  1. *******************************************************************************
  2. BECAUSE THE INSTALLATION OF THE COMPONENTS ON THIS CD IS SEQUENCE SENSITIVE
  3. IT IS HIGHLY RECOMMENDED THAT YOU PRINT, READ AND REFER TO THIS READ.ME FILE
  4. WHILE CONDUCTING THE INSTALLATION
  5. *******************************************************************************
  6.  
  7. Welcome to the installation of the Visual Realty Application.
  8.  
  9. This application comes in two flavors:
  10.   - the application sample:
  11.     this is the sample application as described in the book.
  12.     Only the property subsystem is implemented
  13.  
  14.   - the full application:
  15.     all the subsystems are implemented in this application
  16.     (property, buyer, sale and service subsystems).
  17.  
  18. To install and run the application you must proceed in the following order:
  19. 1. Install DB2/2
  20. 2. Install VisualAge for C++ for OS/2 (if you don't have it)
  21. 3. Install the Visual Realty Application (full or book versions, or both)
  22. 4. Install the sample database to run the Visual Realty Application
  23.  
  24.  
  25. <<<<< After the installation of each component you MUST reboot your machine >>>>
  26.  
  27.  
  28. To start the installation of each product:
  29. 1. Open an OS/2 session (window or fullscreen)
  30. 2. At the command prompt change to your CD-ROM drive
  31. 3. type INSTALL and validate with the ENTER key
  32.  
  33. A main panel is displayed. From this main panel, you can install each
  34. product in the order mentioned above.
  35.  
  36.  
  37. ===============================================================================
  38. 1. Installing DB2/2
  39. ===============================================================================
  40. To install DB2/V2 on your system, select the product from the main panel
  41. and push the Install push-button. You are guided to select the products
  42. you want to install and the disk the products are going to be installed on.
  43. To run the Visual Realty application you need at least to select the
  44. IBM DB2 for OS/2 - Single-User product.
  45.  
  46. Once DB2/2 is installed on your system, you must reboot your system to activate
  47. the changes in your CONFIG.SYS.
  48.  
  49.  
  50. ===============================================================================
  51. 2. Installing VisualAge for C++
  52. ===============================================================================
  53. To install VisualAge C++ on your system, select the product from the main panel
  54. and push the Install push-button. You are guided to select the components
  55. you want to install and the disk the components are going to be installed on.
  56. To run the Visual Realty application and build the sample as described in
  57. the book, you need to install the following components:
  58.    - Compiler and Runtime Libraries
  59.    - WorkFrame
  60.    - Class Browser
  61.    - Visual Builder
  62.    - Data Access Builder
  63.    - IBM Open Class Libraries
  64.    - Standard Class Libraries
  65.    - Warp Toolkit Development Tools
  66.    - Warp Toolkit Headers & Libraries
  67.  
  68. 84 MB of free-space on your disk are necessary to install the above components,
  69. 190 MB, if you want to install all the components.
  70. Even if your system is running OS/2 2.1, you do need to install the Warp Toolkit
  71. components.
  72.  
  73. The VisualAge for C++ installation is a two steps process: YOU NEED TO REBOOT
  74. YOUR SYSTEM AFTER THE FIRST STEP TO COMPLETE THE INSTALLATION.
  75.  
  76. The trial version of VisualAge for C++ contains already the necessary CSDs
  77. to run the Visual Realty Application with DB2/2 V2.0.1. One more step
  78. is necessary to activate the CSDs (see WARNING below).
  79.  
  80. If you already had VisualAge for C++ installed on your machine, you must
  81. ensure that you have the following CSDs installed:
  82.    - CTV303 or above (Visual Builder)
  83.    - CTW301 or above (WorkFrame/2)
  84.  
  85. You can download those CSDs from different sites. Refer to the book
  86. for the VisualAge for C++ Support.
  87.  
  88. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  89.  
  90. WARNING: Once VisualAge for C++ is installed and the second step of the
  91. installation is completed, YOU MUST EXECUTE THE FOLLOWING FILES, LOCATED ON
  92. YOUR CDROM (LET'S SAY G:), IN THIS ORDER:
  93.  
  94. G:\VACPP\IBMCPP\BIN\CTV302A.EXE
  95. G:\VACPP\IBMCPP\BIN\CTV302AI.CMD
  96. G:\VACPP\IBMCPP\BIN\CTV303A.EXE
  97.  
  98. Also, you must change the Resource Compiler
  99. options in the default VACPP project (in X:\IBMCPP\MAINPRJ, where X: is the drive
  100. where VisualAge for C++ has been installed) so
  101. that it will apply to all your projects that inherit from it.
  102.  
  103. The default Resource Compiler options are currently set to
  104. "%q%n.RES".  You need to change it to ".\%n.RES" so that the
  105. correct make file will be generated by MakeMake.  Follow these
  106. steps to accomplish this:
  107.  
  108.    1) Through the Drives folders, find your VACPP project in
  109.       the \IBMCPP\MAINPRJ\VACPP subdirectory.  Open the project.
  110.    2) Go to the Tools Setup window of the default project.
  111.    2) Expand the Compile action.
  112.    3) Right mouse click on the Resource Compiler icon.
  113.       and select the "File Options->Change" menu selection
  114.    5) In the Parameters field, change "%q" to ".\"
  115.  
  116. Read READ.CTV and READ.CTW located on your CDROM for more information.
  117.  
  118.  
  119. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  120.  
  121.  
  122.  
  123. ===============================================================================
  124. 3. Installing the Visual Realty Application
  125. ===============================================================================
  126. To install the Visual Realty Application on your system, select the application
  127. from the main installation panel and push the Install push-button.
  128.  
  129. A Visual Realty folder will be installled on your desktop. This folder contains:
  130.    - the full application ready to run
  131.    - the WorkFrame project of the sample application as described in the book
  132.    - the WorkFrame project of the full application
  133.    - the WorkFrame project of the sample application as described in the book
  134.    - this READ.ME file.
  135.  
  136. Only the source of the FULL application is provided and can be built. To build
  137. the BOOK project you must regenerate the source files using the Visual Builder.
  138.  
  139. Ensure the database is installed before you attempt to build the project.
  140.  
  141. WARNING:  Because building the project involves binding to the database,
  142. the database MUST be started before you start the build process.  Do so
  143. by typing:  STARTDBM at the command prompt on any OS/2 window, use a userid
  144. and password with the ADMINISTRATION authority (usually userid USERID and 
  145. and password PASSWORD are predefined) for the user id and password when prompted.
  146.  
  147. You can rebuild the whole project by selecting Build -> Rebuild All from the
  148. Project menubar option of the Visual Realty Full project.
  149.  
  150. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  151.  
  152. WARNING: When you rebuild your Visual Realty project, the compiler may insert
  153. a trailing message in you resource files (.RC?) indicating the number of
  154. remaining days to use the Trial version. To avoid errors when the
  155. resource compiler is invoked on such a file, you must remove the message
  156. with your favorite editor and select: Project ->Make from the
  157. Project menubar option of the Visual Realty Full project, to remake the project.
  158.  
  159. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  160.  
  161. The Visual Realty Full project organization is described as follow:
  162.  
  163.    Visual Realty Full Project
  164.       |
  165.       |----Help Project
  166.       |
  167.       |----Property Project
  168.              |
  169.              |----Buyer Project
  170.                    |
  171.                    |----Sale Project
  172.                           |
  173.                           |----Service Project
  174.                                  |
  175.                                  |----Common Project
  176.                                  |----Dacslib Project
  177.  
  178. The directory structure is mapped to the following organization:
  179.  
  180.       Drive:\Directory of Visual Realty
  181.                   |
  182.                   |----HELP
  183.                   |----PROPERTY
  184.                   |----BUYER
  185.                   |----SALE
  186.                   |----SERVICE
  187.                   |----COMMON
  188.                   |----DACSLIB
  189.  
  190. The installation of the Visual Realty prompts you for updating your CONFIG.SYS
  191. for the proper access to the DLL and HLP files.
  192.  
  193. ===============================================================================
  194. 4. Installing the Visual Realty Database
  195. ===============================================================================
  196. To install the Visual Realty Database on your system, select the
  197. Visual Realty Application database sample from the main installation panel
  198. and push the Install push-button.
  199.  
  200. On the next panel select the destination drive for the database and press
  201. the Install button.
  202.  
  203. If Database Manager is not started, the programs starts it automatically and 
  204. prompt you to enter a userid and password with the administration authority.
  205. You MUST be logged on with an ADMINISTRATION AUTHORITY password to create
  206. the database. Usually, userid USERID and password PASSWORD are already
  207. predefined with such an autorithy.
  208.  
  209.  
  210. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  211.  
  212. NOTE:
  213.  
  214. 1. On the last step of the database installation, "Binding application
  215.    to the database", you may experience blanking of the installation screen
  216.    this only occurs on some video drivers and does not in any way interfere
  217.    with the operation being performed. Sizing the window will force a repaint
  218.    of the window. Wait until the completion message box appears before
  219.    selecting "Exit". Depending on you machine's speed this could be a few minutes
  220.    from the time "binding" starts.
  221.  
  222. 2. For those who run DB2 1.2, you must rebuild the Visual Realty Project
  223.    to regenerate the bind files since the bind files provided in the CDROM
  224.    have been built with DB2 V2 and are not compatible with DB2 1.2.
  225.    You rebuild the whole project by selecting Project->Rebuild All from the
  226.    toolbar menu of the Visual Realty Full Project.
  227.  
  228.  
  229. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  230.  
  231. Have Fun!
  232.  
  233.